home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archivers / ARCHandler / ARCHandler.txt < prev    next >
Text File  |  1996-09-26  |  20KB  |  415 lines
  1.  
  2.                               ARCHandler 2.1
  3.                              ================
  4.  
  5.          ARCHandler is Copyright © 1994, 1995 Rafael D'Halleweyn.
  6.                            All rights reserved.
  7.  
  8.  
  9. 0. Contents
  10. -----------
  11.  
  12.   1. Introduction
  13.   2. Distribution
  14.   3. History
  15.  
  16. For  full  documentation  you  should  read the included AmigaGuide (in the
  17. `Help' drawer).
  18.  
  19.  
  20. 1. Introduction
  21. ---------------
  22.  
  23. ARCHandler  installs  a filesystem that gives you transparent access to the
  24. files  in  archives:  you can read, change and execute those files/programs
  25. from archives without the need to extract them first.
  26.  
  27. You can test the program without installing it first, just double-click the
  28. `ARCHandler'.
  29.  
  30. When  you  have  decided  to install ARCHandler you should use the included
  31. `Install' script. It needs the Commodore `Installer' program. The Installer
  32. program  should  be somewhere in your path. You can use the `Remove' script
  33. to deinstall ARCHandler.
  34.  
  35. The `Script' drawer contains several scripts for directory utilities. These
  36. are not installed by the Install script.
  37.  
  38.  
  39. 2. Distribution
  40. ---------------
  41.  
  42. This package is released as shareware. This means you can copy it freely as
  43. long  as  you  don't ask any money for it, except perhaps a nominal fee for
  44. copying.  If  you  use this package on a regular base, you should send me a
  45. contribution of 500 BEF or USD 20. Send money by International Money Order,
  46. EuroCheck (in BEF!) or Cash.
  47.  
  48. Magazines that want to include ARCHandler on their coverdisk(s) should also
  49. register  ARCHandler  (one  registration fee) and send one free copy of the
  50. magazine (including disks) to the author.
  51.  
  52. The  package  is  Copyright  © Rafael D'Halleweyn, All Rights Reserved. The
  53. author  reserves the right to change the status of this package whenever he
  54. finds it appropriate.
  55.  
  56. This  package  should  not  be  spread  in  any  other form than an LhA (or
  57. equivalent)  archive  and  all  parts  of it should be spread together. The
  58. package  may  not  be  altered in any way and cannot be used for commercial
  59. purposes  without  the  prior written permission of the author. The archive
  60. should contain the following files:
  61.       ARCHandler (dir)
  62.           ARCFiles
  63.             Disk.info
  64.             Drawer.info
  65.             Volume.info
  66.           C (dir)
  67.             FindCommand
  68.             FromARC
  69.             PrefLanguage
  70.             StartARC
  71.             StartARC.info
  72.             ToARC
  73.           Catalogs (dir)
  74.             «language» (dir)
  75.               archandler.catalog
  76.             ...
  77.             archandler.cd
  78.           Help (dir)
  79.             «language».info
  80.             «language» (dir)
  81.               ARCHandler.guide
  82.             ...
  83.             Pictures (dir)
  84.               ARCHandlerArcPrefs.pic
  85.               ARCHandlerCxPrefs.pic
  86.               ARCHandlerDevPrefs.pic
  87.               ARCHandlerKeyReq.pic
  88.               ARCHandlerMain.pic
  89.           Scripts (dir)
  90.             FromARC.dmrx
  91.             FromARC.dopus
  92.             Scripts.txt
  93.             Scripts.txt.info
  94.             ToARC.dmrx
  95.             ToARC.dopus
  96.         ARCHandler
  97.         ARCHandler.info
  98.         ARCHandler.txt
  99.         ARCHandler.txt.info
  100.         Help.info
  101.         Install
  102.         Install.info
  103.         Remove
  104.         Remove.info
  105.         Scripts.info
  106.     ARCHandler.info
  107.  
  108. Distribution  of  the program on any medium (CD, floppy, ...) in such a way
  109. that  it is ready to be used (eg. as a front-end for a CD-ROM) requires the
  110. permission of the author.
  111.  
  112. The   installation-script  (`Install')  and  the  extra  commands  it  uses
  113. (`FindCommand',  `PrefLanguage'  and  `StartARC')  are also copyrighted and
  114. can't  be  used  in  any  other  project/archive  without the prior written
  115. permission of the author.
  116.  
  117.  
  118. 3. History
  119. ----------
  120.  
  121. ===========================================================================
  122.  
  123.   ·release 1.0 [37.129 (12.7.94)]
  124.     -First release.
  125.  
  126.   -----------------------------------------------------------------------
  127.  
  128.   ·release 1.0a [37.131 (14.7.94)]
  129.     -Volumes  that  have  the  same  name as a device couldn't be used
  130.      through the handler (reported by Erik Bergen).
  131.     -Removed a nasty Enforcer hit.
  132.     -Made some changes to the installation script.
  133.  
  134. ===========================================================================
  135.  
  136.   ·release 1.1 [37.157 (21.8.94)] «never released»
  137.     -ARCHandler now uses it's own routine to list  lha-archives.  As a
  138.      result, ARCHandler no longer  needs the PIPE-device.  The strange
  139.      files, that sometimes showed up, should also be gone.  Listing is
  140.      now also a bit faster.
  141.     -Files  are now  extracted much  faster (upto 5  times faster  for
  142.      small files like icons).
  143.     -ARCHandler won't start to list an archive when another process is
  144.      already listing the same archive.
  145.     -Added a '.backdrop' file  to the root of the filesystem.  Now you
  146.      can permanently leave out files and drawers.
  147.     -The  handler  now  supports  ACTION_COPY_DIR_FH  (DupLockFromFH),
  148.      ACTION_EXAMINE_FH (ExamineFH), and ACTION_PARENT_FH (ParentOfFH).
  149.      Suggested  by  Nicola  Salmoria  and  Matthias Scheler. Currently
  150.      these  packets only work with normal files and files in archives,
  151.      they  don't  work  with  the extra icons the handler produces nor
  152.      with the backdrop-file.
  153.     -ARCHandler  now adds a '/' to TEMPDIR  when there wasn't one (LhA
  154.      needs this). Suggested by Tattoo Mabonzo.
  155.     -ARCHandler no  longer  uses  LhA  to extract  uncompressed  files
  156.      (`-lh0-'), this should speed up access to archives in archives.
  157.     -Added a new startup-option:  ONLYEXT;  when you use  the ONLYEXT-
  158.      option,  ARCHandler  will  only  check  the filename-extension to
  159.      decide on the filetype (suggested by Nicola Salmoria).
  160.     -Some  preparations  for a writable  filesystem  and some  general
  161.      fixes.
  162.     -ARCHandler now  returns a `disk not validated'-error when there's
  163.      something wrong with an archive or with LhA.
  164.     -The  handler  now  adds  DISKINSERTED/DISKREMOVED  events to  the
  165.      input  stream  when it's started/removed. This way, the Workbench
  166.      notices the new volume faster.
  167.     -Added  two  support commands for shell users,  ToARC and FromARC.
  168.     -The  DISKICON  and  DRAWERICON  arguments  may  now  be  upto  96
  169.      characters.
  170.     -`Smarter' installation script.
  171.     -Added ToARC and FromARC scripts for DiskMaster.
  172.  
  173. ===========================================================================
  174.  
  175.   ·release 2.0 [37.290 (3.2.95)]
  176.     -ARCHandler  is  no  longer  a real handler (one that lives in the
  177.      'L:'  directory).  Instead,  ARCHandler is now a program, you can
  178.      place it everywhere, even in your WbStartup directory.
  179.     -The most visible  change is the  graphical user  interface (GUI).
  180.      The  GUI  is  fully  font/locale  sensitive.  Almost  all  of the
  181.      settings  can be changed (and saved) with this GUI (you no longer
  182.      have  to  mess with the `Startup' field). The settings that can't
  183.      be  changed with the GUI are set while installing ARCHandler. The
  184.      GUI has context sensitive online-help.
  185.     -The  internals  of  the handler have completly been rewritten. It
  186.      now  uses  coroutines  to  implement a multi-threaded filesystem:
  187.      there's  no longer a need for extra processes to complete packets
  188.      (an  ACTION_FINDINPUT  of  an  archive  will  still need an extra
  189.      process   since   LhA   can't  be  used  in  this  multi-threaded
  190.      environment, the same is true for the filerequesters).
  191.     -ARCHandler is now also a commodity, with a `Hot Key' and a `Flush
  192.      Key'.
  193.     -Instead  of  scanning  the  DosList  on every ACTION_EXAMINE_NEXT
  194.      packet,  ARCHandler  now scans the DosList every x seconds (x can
  195.      be changed).
  196.     -ARCHandler  also  listens to DISKINSERT, DISKREMOVED events. Both
  197.      events  will  trigger  a  rescan  of the DosList. ARCHandler also
  198.      checks the list of archives, when it finds an archive that exists
  199.      on  a  removed volume, the archive will be freed if it was not in
  200.      use  (or if it is in use, it will be freed when the archive is no
  201.      longer in use).
  202.     -The `FlushARC' command  is  gone, there's now a `Flush Key' and a
  203.      'Flush'  gadget. The use of the DISKINSERT and DISKREMOVED events
  204.      should  also  replace  some  uses of this command. The `FlushARC'
  205.      command  will  no longer work, please delete it if you still have
  206.      it.
  207.     -All  the  extra files that ARCHandler needs are now placed in one
  208.      directory  (default is `PROGDIR:ARCFiles'). This directory should
  209.      contain  a `Volume.info', resp. a `Drawer.info' if you want icons
  210.      for volumes without a disk-icon, resp. icons for archives.
  211.     -Non-archive   files   are   now   writable.  The  default  volume
  212.      `Disk.info'  and the icon for the archives are also writable (the
  213.      position information of the icon is ignored).
  214.     -ACTION_LOCATE_OBJECT  (Lock()) supports exclusive  (ACCESS_WRITE)
  215.      locks.
  216.     -The filesystem now has full support for the following packets:
  217.        ACTION_COPY_DIR_FH;
  218.        ACTION_EXAMINE_FH;
  219.        ACTION_FH_FROM_LOCK;
  220.        ACTION_PARENT_FH and
  221.        ACTION_RENAME_DISK.
  222.      It also has partial support for the following packets:
  223.        ACTION_CHANGE_MODE;
  224.        ACTION_FINDOUTPUT;
  225.        ACTION_FINDUPDATE;
  226.        ACTION_DELETE_OBJECT;
  227.        ACTION_RENAME_OBJECT;
  228.        ACTION_SET_COMMENT;
  229.        ACTION_SET_DATE;
  230.        ACTION_SET_OWNER;
  231.        ACTION_SET_PROTECT;
  232.        ACTION_SET_FILE_SIZE.
  233.     -ARCHandler  should  now  also work correctly on systems using the
  234.      MultiUser FileSystem (muFS). I hope to add full MultiUser support
  235.      in  a  future  version.  The  only  thing  that has to be done is
  236.      access-checking.  ACTION_EXAMINE_OBJECT  and  ACTION_EXAMINE_NEXT
  237.      should already return the correct protection/file owner, even for
  238.      the virtual files (icons), these are always owned by root and are
  239.      readable by all, but only changeable by root.
  240.     -The  ARCHandler  archive  contains  NewIcons. You won't see these
  241.      icons  unless  you  have  the  NewIcons package installed. If you
  242.      don't  have  the  NewIcons  package  installed you can remove the
  243.      `IM1'  and  `IM2'  tooltypes.  NewIcons  was  written  by  Nicola
  244.      Salmoria, the artwork is based on work by Roger McVey.
  245.  
  246.   -----------------------------------------------------------------------
  247.  
  248.   ·release 2.0a [37.312 (11.4.95)]
  249.     -Because of the low number of new registrations I have been forced
  250.      to  protect my  hard  work  with a  key file.  Everybody who  has
  251.      registered  should already have his/her key file. An unregistered
  252.      copy  will  pop  up the main ARCHandler window from time to time.
  253.      The  KEEPTIME  (see  further) and BUFFERS arguments are sometimes
  254.      reset to zero. Using an illegal key file is DANGEROUS!
  255.     -When  an extracted  file is closed  it isn't immediatly  deleted.
  256.      When  the same  file is  opened  again in a short  time, the file
  257.      doesn't have to  be reextracted.  This speeds  up access  through
  258.      MultiView and directory  utilities.  The time a file  is kept can
  259.      be changed with the KEEPTIME  argument/tooltype  (defaults to two
  260.      seconds). There's no slider to change it yet.
  261.     -You  can  now  use  devices  and assigns in the root directory. A
  262.      device  will  be expanded to its volume (if it has one, otherwise
  263.      it  will  fail),  an  assign  will  be expanded to its path (only
  264.      binding,  non-late  assigns,  using  the  first  part  of a multi
  265.      assign).
  266.     -Sometimes an archive whose  contents wasn't yet completely parsed
  267.      was already flushed.  This generated several Enforcer hits.  This
  268.      error only occured under  very rare conditions  and was very hard
  269.      to find.
  270.     -ARCHandler has never been able to use directories deeper then 254
  271.      levels (that should be enough), but it never checked if you tried
  272.      to  go  deeper  (you  almost never do). ARCHandler will no longer
  273.      allow  you  to  go  any deeper, it will return with an error "too
  274.      many levels".
  275.      This  only  gave  problems  when  you  used the Workbench to copy
  276.      `Archives:Ram  Disk'  to `Ram Disk'. This resulted in a very long
  277.      chain  of  directories `Ram Disk:Ram Disk/Ram Disk/...', that way
  278.      you quickly reached the 254 limit.
  279.     -You can now rename archives.  I also changed  (fixed?) some other
  280.      renaming stuff.
  281.     -ARCHandler could lock up  when you used it to access  archives in
  282.      archives (ie. Archives:Archives/Work/arc1.lha/arc2.lha/file.txt).
  283.     -Fixed some things that could cause an Enforcer hit.
  284.     -Fixed  something  in the  multithreading  that could  have messed
  285.      things up pretty badly.
  286.     -After using an archive in an  archive you no longer have to flush
  287.      before you can quit.
  288.     -Slashes  are  removed  from  the  start  of  directory  names  in
  289.      archives.
  290.     -The key up events were  also used when  you used the  keyboard to
  291.      change a  slider  or a  checkbox  (causing  a slider  to move two
  292.      positions).
  293.     -Device   Preferences  wouldn't   show  the  actual   priority  of
  294.      ARCHandler  (ie.  you  used a utility  to change  the priority of
  295.      ARCHandler).
  296.     -When you  had seeked  through a  volume icon  in the root  of the
  297.      filesystem  ARCHandler  no longer  changed  the icon  to a drawer
  298.      icon. This shows when  you are using PDPro.  Reported by Kaikumaa
  299.      Timo.
  300.      While testing ARCHandler with  PDPro I had several other crashes,
  301.      I still  had crashes  when ARCHandler  was NOT running!  I do not
  302.      recommend using PDPro together with ARCHandler!
  303.     -Small problem fixed that happened when a file extraction failed.
  304.      ARCHandler  now  returns  an ERROR_OBJECT_NOT_FOUND when it finds
  305.      that  the archive is corrupt. The Workbench didn't like the other
  306.      errors.
  307.     -ARCHandler couldn't be started from ToolManager, fixed.
  308.     -Using ASLFR_DoSaveMode tag for directory requesters.  This allows
  309.      you to create new drawers from within the directory requesters.
  310.     -An exclusive lock in an archive wasn't correctly unlocked.
  311.     -Recompiled with SAS-C 6.55.
  312.     -Split Installer options in two so that they are all visible.
  313.     -Install script  forgot to add 'LhA'  to the path it  got from the
  314.      user when it couldn't find 'LhA' by itself.
  315.     -Included German translations by Martin Stengle. Thanks Martin.
  316.     -Included French translations by Florent Monteilhet. Thanks.
  317.     -Removed  some mistakes reported by Erik Bergen from the guide and
  318.      the installation script
  319.  
  320.   -----------------------------------------------------------------------
  321.  
  322.   ·release 2.0b [37.352 (23.7.95)]
  323.     -Complete support for six actions:
  324.          ACTION_CREATE_DIR       [CreateDir()];
  325.          ACTION_DELETE_OBJECT    [DeleteFile()];
  326.          ACTION_RENAME_OBJECT    [Rename()];
  327.          ACTION_SET_COMMENT      [SetComment()];
  328.          ACTION_SET_DATE         [SetFileData()] and
  329.          ACTION_SET_PROTECT      [SetProtection()].
  330.      Please note that small changes in a  large  archive  can  take  a
  331.      _very_ long time: be patient.
  332.     -Removed  bug  that was introduced in 2.0a: the number of archives
  333.      in  use  could  become  negative,  this prevented ARCHandler from
  334.      quitting.
  335.     -All windows and requesters are now build by my own layout engine.
  336.      This has resulted in some changes to the GUI.
  337.     -All  non-requester  windows  have  menus  (with  menu-help).  The
  338.      preference windows have menu items to restore, use the last saved
  339.      or use the default preferences.
  340.     -All  archive  specific  preferences  can  now  be  changed from a
  341.      seperate window.
  342.     -The  KEEPTIME  argument  can  now be changed with a slider in the
  343.      archive preferences window.
  344.     -The  archive  preferences  window  now contains a cycle gadget to
  345.      select  the  type  of archive recognition: filename, filename and
  346.      contents,  contents only. The 'Only Extension' checkmark is gone.
  347.      The 'ONLYEXTENSION' argument is now obsolote (but still suported)
  348.      and   superseded   by  the  'RECOGNITION'  argument  (short  form
  349.      'RECOG').  RECOGNITION  takes a number from 0 to 2 indicating the
  350.      recognition type (0: filename, 1: name and contents...).
  351.     -LhA-archives with type 1 header weren't handled correctly.
  352.     -ACTION_DISK_INFO and ACTION_INFO now return a more sensible value
  353.      for id_NumBlocks and id_NumBlocksUsed.
  354.     -ACTION_DISK_INFO  and  ACTION_INFO said that the volume was write
  355.      protected.
  356.     -The  keyrequester  is  now resizable. And the key-gadget is now a
  357.      real gadget (and a bit different).
  358.     -The  message  port pointed to by the dol_Task field in the device
  359.      node  is  now  named  (its  name is the name of the device). This
  360.      should  prevent  Diavolo  Backup  from  generating Enforcer hits.
  361.      Reported by Martin Korndörfer, author of Diavolo Backup.
  362.     -Changed  FindCommand  and  PrefLanguage (commands used by Install
  363.      script).  I  hope this fixes problems with the Install script and
  364.      different shells.
  365.     -The  preference windows won't close when you are trying to use or
  366.      save an impossible setting.
  367.     -Changed  the behaviour of the unregistered version a bit: it will
  368.      only  pop  up the nag requester when it is started and when it is
  369.      finished,  and  saves of the preferences are ignored (you can use
  370.      the Tool Types to change them).
  371.     -Tried to use memory pools where-ever possible.
  372.     -Smarter  buffer  allocation,  I try  to  allocate  a  large block
  373.      without  expunge,  and  if  that fails I try a smaller block with
  374.      expunge.
  375.     -When  there  is a problem with the underlying filesystem ('volume
  376.      not mounted', 'disk is full', ...) you should get the name of the
  377.      volume  with  the  problem  (instead of 'Volume Archives is write
  378.      protected'). ARCHandler uses its own requesters for this.
  379.     -Optimized unnecessary seeks.
  380.     -FromARC didn't work, fixed.
  381.     -Danish translation by Jacob Laursen, thanks.
  382.     -Finnish translation by Timo Kaikumaa, thanks.
  383.  
  384. ===========================================================================
  385.  
  386.   ·release 2.0c [37.355 (4.10.95)]
  387.     -ARCHandler wasn't able  to  use  fonts  that  contained  all  the
  388.      characters  (from  0  to  255, XHelvetice is an example of such a
  389.      font).
  390.     -You can now use 'ARC:.' to get  to  the  same  directory  as  the
  391.      current  directory  but  on  the  Archives:  volume.  This should
  392.      replace ToARC.
  393.     -I was using to much options to link FromARC and ToARC.  Using the
  394.      correct options I was able to reduce their size by 50%.
  395.     -ARCHandler  sometimes  marked  the  icons  for  the  volumes   as
  396.      directories, tried to change that.
  397.     -Tested ARCHandler with the Ami-FileSafe  demo  from  Aminet.  AFS
  398.      seems  to  think  that  ACTION_FINDUDPATE  (MODE_READWRITE) gives
  399.      exclusive access to a file (this is different from  the  standard
  400.      FastFileSystem).  As a result ARCHandler can't change archives on
  401.      an AFS partition.
  402.  
  403. ===========================================================================
  404.  
  405.   ·future release?
  406.     -Fully  writable  filesystem,  with  the  ability to create/change
  407.      files in archives.
  408.     -Support for more archive types (zip/zoo/tar/...).
  409.     -Support for crunched files (XPK/PowerPacker/Imploder/...).
  410.  
  411. These  are  just  some  of  the features I might add to a future release. I
  412. don't  guarantee that any of these features will ever be implemented (but I
  413. hope  they  will). If you've got any good ideas for a future release let me
  414. know.
  415.